home *** CD-ROM | disk | FTP | other *** search
/ United Public Domain Gold 2 / United Public Domain Gold 2.iso / utilities / pu665.dms / pu665.adf / MAKEDL / makedl.man < prev    next >
Text File  |  1994-07-26  |  5KB  |  155 lines
  1.  
  2.  
  3.  
  4.     MAKEDL 1.0                                                26.07.94
  5.  
  6.  
  7.  
  8.     ABOUT
  9.  
  10.     This is a CLI-based DL animation creator for machines with KS 2.0
  11.     or better. It creates version 2 DL files based on a script that
  12.     you give it, much like MKANIM and similar programs.
  13.  
  14.     DL files are a kind of animation once found only on PCs. The
  15.     animations are either 320x200, 160x100, or 80x50, in 256 colors.
  16.     The colors are 18 bits each, 6 per gun.
  17.  
  18.     MAKEDL is Copyright © 1994 by John Bickers.
  19.  
  20.  
  21.     REQUIREMENTS
  22.  
  23.     MAKEDL requires a machine with at least KS2.0, and Christian
  24.     Weber's IFF library. The IFF library can be found on the Aminet
  25.     sites, and has to be no older than version 22.
  26.  
  27.  
  28.     PARAMETERS
  29.  
  30.     The command template is:
  31.  
  32.     DL/A,SCRIPT/A,24BIT/S
  33.  
  34.     The DL option is the name of the DL file you want to create, and
  35.     must be present.
  36.  
  37.     The SCRIPT option is also required, and is the name of the script
  38.     file that will define what goes into the animation. The script
  39.     file format is described below.
  40.  
  41.     The 24BIT option lets you force the palette in the DL file to be
  42.     a 24-bit palette. The format really wants an 18-bit palette, but
  43.     the TAPDL player on the Amiga is capable of handling both. Be
  44.     warned that an animation with a 24-bit palette will NOT play back
  45.     correctly on a PC, and I don't think that the difference in color
  46.     quality is really worth the hassle.
  47.  
  48.  
  49.     SCRIPT FILE FORMAT
  50.  
  51.     A script file is a simple text file containing a number of lines
  52.     of the form "<item> = <value>". The items are...
  53.  
  54.     title       A title for the animation. This has a maximum length
  55.                 of 20 characters.
  56.  
  57.     author      The author of the animation. Put your name here. This
  58.                 field also has a maximum length of 20 characters.
  59.  
  60.     model       This is a number, either 0, 1 or 2. These represent
  61.                 the dimensions of the animation, either 320x200,
  62.                 160x100, or 80x50 respectively.
  63.  
  64.     frame       The name of the IFF file containing a frame of the
  65.                 animation. There can be more than one frame field, and
  66.                 they should appear in the same order that you will
  67.                 index them in the command field. The dimensions of
  68.                 each frame should match the dimensions you select with
  69.                 the model field, but this isn't totally necessary. The
  70.                 IFF library tries to clip or pad bitmaps as required.
  71.  
  72.     command     A command sequence for controlling the playback of the
  73.                 animation. This is a list of values seperated by
  74.                 commas, where a value can be one of...
  75.  
  76.                 1.  A frame index, counting from 0. The frame you
  77.                     select will be the frame displayed at this point,
  78.                     with a default delay of 5/100ths of a second
  79.                     between frames.
  80.  
  81.                 2.  A loop indicator, L<N>, where N is the number of
  82.                     times that the loop should be executed. Note that
  83.                     the entire animation will loop ad infinitum, so an
  84.                     L<N> is only required for sub-loops.
  85.  
  86.                 3.  An end-of-loop indicator, E.
  87.  
  88.                 4.  A pause indicator, P<N>, where the pause will be
  89.                     N/100ths of a second long.
  90.  
  91.     As a test, which I can't distribute because of the nature of the
  92.     picture involved, I created 6 160x100/8 brushes that scrolled down
  93.     the centre of a picture (debanimation). The script file to create
  94.     a DL anim from these brushes looked like...
  95.  
  96.                 title = TEST ANIM
  97.                 author = John Bickers
  98.                 model = 1
  99.                 frame = suelin1.iff
  100.                 frame = suelin2.iff
  101.                 frame = suelin3.iff
  102.                 frame = suelin4.iff
  103.                 frame = suelin5.iff
  104.                 frame = suelin6.iff
  105.                 command = 0,1,2,3,4,5,4,3,2,1
  106.  
  107.  
  108.     CREDITS
  109.  
  110.     MAKEDL is written by John Bickers using SAS C 6.51.
  111.  
  112.     The DL file format and PC programs were created by Davide Tome'
  113.     and Luca De Gregorio. The format of a DL file was obtained by
  114.     looking at sample files, and running Davide and Luca's DL-VIEW.EXE
  115.     under Microsoft's CodeView debugger.
  116.  
  117.     Thanks to Christian Geisert for a variety of sample files.
  118.  
  119.     Christian A. Weber's iff.library is used for loading ILBM files.
  120.  
  121.  
  122.     DISTRIBUTION
  123.  
  124.     MAKEDL is Copyright © 1994 by John Bickers.
  125.  
  126.     Distribution is via normal channels. That is, distribute it for
  127.     free, or for Fred Fish like costs, but not more. And remember to
  128.     include the documentation.
  129.  
  130.     If you use this program, I'd be keenly interested in a copy of the
  131.     animations that you create. I'm also interested in any suggestions
  132.     that you may have for making this program easier to use.
  133.  
  134.  
  135.     CONTACT INFO
  136.  
  137.     I can be reached at:
  138.  
  139.         John Bickers
  140.         214 Rata St
  141.         Naenae
  142.         New Zealand
  143.  
  144.     Or: jbickers@templar.actrix.gen.nz
  145.  
  146.  
  147.     DISCLAIMER
  148.  
  149.     It works on my machine.
  150.  
  151.  
  152.     HISTORY
  153.  
  154.     94.07.25    Created 1.0.
  155.